home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
programs
/
olz13.zip
/
OLZ.BAK
< prev
next >
Wrap
Text File
|
1993-02-08
|
15KB
|
328 lines
┌────────────────────────────────┐
│ AvernusWare Proudly Presents │
│ │
│ OneLinerZ! v1.3 │
│ Programmed by Dennis Alexander │
│ Copyright 1993 │
└────────────────────────────────┘
Introduction
────────────
Hello and welcome to OneLinerZ! This program was
written, and should work for the following BBS programs:
Renegade, T.A.G., and Telegard. The program works best on
Renegade and Telegard, but should work on T.A.G. as well.
What is this program? OneLinerZ! is a program based on a
"rumors" program I have seen for other BBS softwares such
as Celerity. The program allows users to enter one line
of ANSI, AVATAR or ASCII text, usually the oneliners are
something like this: "Press ALT-H for SysOp access!!", or
often they are used to advertise bulletin boards, "Call
AVERNUS at 313.427.0224!", etc. If you have any problems
with the program, bugs to report, or suggestions, please
let me know at the above BBS if possible.
Disclaimer
──────────
This program contains NO guarantees or warrantees.
Use it at your own risk. I HIGHLY doubt, however, that it
can do ANY damage whatsoever to your computer or BBS, so
you shouldn't worry. This program doesn't touch ANY of
your BBSs data files.
Registration
────────────
HA! This program is FreeWare. By using this
program it is payment enough for me. I also do not
believe in charging for little BBS utilities. Support the
Hacker Ethic and FREE INFORMATION. (I'm talking about
TRUE Hackers, get the book Hackers if you don't know what
I am talking about.)
Packing List
────────────
The archive OLZ-13.ZIP should contain the following:
OLZ.EXE ■ The main program.
OLZ.DOC ■ This file; manual for use.
OLZ.MNU ■ An example Renegade and Telegard menu file
OLZSETUP.EXE ■ To INSTALL and EDIT OneLinerZ!
OLZRAND.EXE ■ Used to randomize OneLiners.
PACKER.EXE ■ Used to weed out deleted records.
AUTODEL.EXE ■ Used to weed out OneLiners x number of days old.
AVERNUS.EXE ■ My shameless BBS ad.
CONVERT.EXE ■ Used in converting older versions of OneLinerZ!
BATCH.ZIP ■ Archived example batch files.
UPGRADE.DOC ■ Upgrade information and history.
README.1ST ■ A disclaimer to UNARCHIVE BATCH.ZIP to your BBS dir.
Installation (For Renegade and Telegard systems)
────────────────────────────────────────────────
Note: This documentation assumes you know something about your
respective BBS software. I cannot provide a key press by
key press tutorial on how to set this up, use your own
common sense!
Preliminary Info
────────────────
The example batch files assume the program is in C:\1LINERS.
The example batch files assume your BBS is in C:\BBS.
The example batch files assume text files are stored in C:\BBS\AFILES.
The example batch files assume you use "SHOW" and "SHOWTEN" as file
prefixes when running OLZRAND.
1) Copy all files to their own directory, ie. C:\1LINERS.
2) Run OLZSETUP.EXE and configure the door file and the
configuration sections. It is fairly well documented, so
I needn't go in to detail here.
3) Unarchive the file BATCH.ZIP to your BBS directory, then
edit the batch files to work on your system. All batch
files begin with the three characters "ONE". You should
have the following batch files (after you unarchive
BATCH.ZIP!) :
ONEADD.BAT ■ This is run to add a OneLiner.
ONEALL.BAT ■ This is run to list ALL OneLiners.
ONEASC.BAT ■ Used to rotate ten (.ASC/.MSG) files.
ONEAVT.BAT ■ Used to rotate ten (.AVT) files.
ONECHANG.BAT ■ This is used to change graphics modes.
ONEDEL.BAT ■ This is run to delete a OneLiner.
ONEDELU.BAT ■ This is used to delete a user from USERFILE.DAT
ONEEDIT.BAT ■ This is run to edit a OneLiner.
ONELIST.BAT ■ This is run to list one OneLiner.
ONENEW.BAT ■ This is used to do a newscan of OneLiners.
ONEPACK.BAT ■ This weeds out deleted OneLiners. Put
this in your night event.
ONEPOINT.BAT ■ This is used to change pointer dates.
ONERAND.BAT ■ This is run to randomize to one file.
ONESRCH.BAT ■ This is used to do a "text" search.
ONETEN.BAT ■ This is run to randomize to ten files.
You could run this everytime a user logs
off, or in a night event.
4) Copy the OLZ.MNU file to your menus directory and edit it
to work on your system.
5) Add the following commands to your main menu:
1. Long Descript : (/O)neLinerZ! - Go to the OneLinerZ! menu
2. Short Descript: (/O)neLinerZ!
3. Menu Keys : /O
4. ACS Required : ""
5. CmdKeys : -/
6. Options : OLZ
Renegade commands:
──────────────────
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "!EV!EN"
5. CmdKeys : -F
6. Options : SHOWTEN
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "EV"
5. CmdKeys : D-
6. Options : oneavt.bat
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "EV"
5. CmdKeys : -F
6. Options : SHOWTEN.AVT
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "EN"
5. CmdKeys : D-
6. Options : oneasc.bat
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "EN"
5. CmdKeys : -F
6. Options : SHOWTEN.ASC
Telegard commands:
──────────────────
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "XA"
5. CmdKeys : -F
6. Options : SHOWTEN
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "XV"
5. CmdKeys : D-
6. Options : oneavt.bat
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "XV"
5. CmdKeys : -F
6. Options : SHOWTEN.AVT
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "!XV!XA"
5. CmdKeys : D-
6. Options : oneasc.bat
1. Long Descript : <this should be set to NULL>
2. Short Descript: <this should be set to NULL>
3. Menu Keys : FIRSTCMD
4. ACS Required : "!XV!XA"
5. CmdKeys : -F
6. Options : SHOWTEN.ASC
Notice: You may add the above commands to any of the other menus
where you want OneLinerZ! to randomly appear.
The above is a SUGGESTED setup for use with Renegade or Telegard.
The great thing about OneLinerZ! is that it is very flexible and
configurable due to it's "modular" nature (separate command line
parameters for separate functions, as opposed to a door with all
commands in a menu within in the door.) If you want to
experiment with different setups, see the documentation below on
command line parameters.
Command Line Parameters for OLZ.EXE
───────────────────────────────────
The format for using parameters with OLZ.EXE is as
follows: OLZ /R# -xx, where # is your node number, and "xx" is
one of the following parameters:
-A ■ Add a OneLiner.
-AL ■ List all OneLiners.
-C ■ Change graphics mode.
-D ■ Delete a OneLiner. The SysOp can delete ANYONE's
OneLiner.
-DU ■ Delete a user from USERFILE.DAT, the ACS for this
command should be s255 or u1 for SysOp use only.
-E ■ Edit a OneLiner. The SysOp can edit ANYONE's
OneLiner.
-L ■ List one OneLiner.
-N ■ Newscan the OneLiner data file.
-P ■ Change pointer date.
-T ■ Do a "text search" of the OneLiner data file.
Make sure that your DORINFO#.DEF file corresponds with
the node parameter that is passed to OLZ.EXE.
Command Line Parameters for OLZRAND.EXE
───────────────────────────────────────
OLZRAND is used to randomize a OneLiner either to one
file, or to ten. Let me first explain what randomizing to ten
means. In the example setup, (Installation section), I suggest
adding a command to the main menu that will display the file
name "SHOWTEN". This is why, OLZRAND will make ten files, such
as: SHOWTEN.ANS, SHOWTEN.AN1, SHOWTEN.AN2, etc, until "AN9". If
you are a veteran SysOp with Renegade or Telegard, then you know
that if you tell the BBS to list a file with just the extension
it will randomly pick one of the ten. "Why is this usefull?"
Well, there is a parameter that allows you to randomize ONE
OneLiner, but if you were to do this everytime at the main menu,
it would be SLOW. Whereas, with the "randomize ten" option, and
with ANSI, you can have the BBS run the batch file ONETEN.BAT to
randomize ten everytime the user logs off, so they don't have to
deal with waiting at the main menu. Other batch files are pro-
vided for AVATAR and ASCII users, that will rotate between ten
(.ASC/.MSG) or (.AVT) files. You are most likely confused, I
am sorry. The best thing to do is to just use the examples.
Finally, the format for using parameters with
OLZRAND.EXE is as follows: OLZRAND +C/-C +O/-O [type] [filename]
+C will add a carriage return after the OneLiner, -C won't.
+O will add the "OneLiner By" string, -O won't.
[type] is one of the following commands:
-S ■ Randomize one OneLiner to one file. (Actually, it
will create three files, ie: SHOW.ANS, SHOW.MSG and
SHOW.AVT)
-R ■ Randomize ten OneLiners to ten separate files. See
explanation above.
[filename] is the **PREFIX** of the file you want to create.
Note: Randomizing is slow because it creates ANSI, AVATAR and
ASCII files every time it is run, that is why it is best
to follow my example in the Install section of this DOC.
Information on PACKER.EXE
─────────────────────────
This should be run in a night event. What this program
does is "weed out" deleted OneLiners. "If they are deleted, why
do they need to be "re-deleted"? Well, when you delete a
OneLiner, it is not physically removed from the file. But, if
you were to add another OneLiner, it would over-write the
deleted one. PACKER removes records PHYSICALLY ... so if you get
too many deleted records, and they are getting annoying, you can
just run this to get rid of them.
Information on AUTODEL.EXE
──────────────────────────
This program accepts ONE parameter, and that is the number
of days to check for. Example: "AUTODEL 30" would delete all
OneLiners that are 30 or more days old.
T.A.G. Users
────────────
I *KNOW* that OneLinerZ! can be set up on TAG, but I am
simply not very familiar with the software. I'm sure it's only a
matter of studying the RG/TG example menu, or reading about the
parameters. I know of two BBSs local to me that have set it up on
TAG, but they don't have the time for DOC writing, sooooo... I'm
sorry! It can be done, if you are an experienced SysOp.
In Conclusion
─────────────
Thank you for using this program, I appreciate it greatly.
If you are having any problems setting up your copy of OneLinerZ!
then please feel free to call my BBS, AVERNUS, at 313.427.0224.
I will be happy to help you set it up, and to take suggestions for
improvements. I can also be reached on ITCNet, in the Renegade
echo, or the utility echo. Call my board for future versions and
future AvernusWare programs.
I would also like to thank Wish Giver, of The Three Wishes
BBS (313.522.2865), for helping me beta test this program.
I would also like to thank The Archon and Vangard.
Dennis Alexander - aka LANKHMAR